home *** CD-ROM | disk | FTP | other *** search
/ Mac Installer 3 / Mac Installer Volume 3 (1996).iso / mac / CavePlot / CP-GenRef / CP-GenRef.rsrc / CPTX_194_CP-Text Commands < prev    next >
Encoding:
Text File  |  1996-10-15  |  4.8 KB  |  114 lines
  1. Explanation of CP-Text Commands
  2.      The following is a listing of currently supported commands for the CavePlot-Text survey data format.   More commands will probably be added in the future.   New commands will always be preceded by an "=" character.
  3.  
  4. =N=   Precedes the name of the Survey
  5.      The rest of the line is put into the survey name.
  6.      Only the first 31 characters are used
  7.      Example  =N=This is a Fake Cave
  8.      This name applies to the entire data file
  9.      For sub-sets of the entire data file, see "Sections"
  10.  
  11. =U=   Precedes the name of the Distance Units
  12.      The rest of the line is put into the Distance Units.
  13.      Only the first 15 characters are used
  14.      Example  =U=Meters
  15.  
  16. =I=   Precedes general information
  17.      The rest of the line is put into General Information.
  18.      Can have more than 1 General Information String
  19.      Total General Info is limited to 30,000 characters.
  20.      Example  =I=This cave is really very awesome.
  21.                     =I=It is so awesome, that we even mapped it.
  22.                     =I=Even so, we could only find 50 meters
  23.                     =I= of cave to map.
  24.  
  25. =C=   Precedes a Station Comment
  26.      The rest of the line is put into a Station Comment.
  27.      Comments are limited to 254 characters per station.
  28.      Example  =C=This station is directly over the pit!
  29.  
  30. =S1=   Precedes a New Section Name
  31. =S2=   ...(1,2,or3 is Sect Set#)
  32. =S3=   ...As Above...
  33.      The rest of the line is a Section Name.
  34.      If not already created, CavePlot adds this Section
  35.      Following stations will all belong to this Section
  36.      These commands work independantly of each other
  37.      Example  =S1=Surface
  38.      Example  =S2=Aug-94
  39.  
  40. =S$=   Specifies Section Num%, Status%, Color%, Name$
  41.      This is used to specify info about a Section
  42.      To work properly, it should precede actual survey data
  43.      Example  =S$= 1  3  2  LeftHandMaze
  44.      This example names Section #1 "LeftHandMaze"
  45.      This example makes Section #1  Plot  Medium Blue
  46.      Status%:  2=Off, 3=Plot, 4=Bold, 5=Dim, Others -->Off
  47.      Color%:    0=White, 1=L-Blue, 2=M-Blue, 3=Green,
  48.           4=Yellow, 5=Red, 6=Magenta, 7=Black, 8=L-Gray
  49.           9=M-Gray, 10=L-Brown, 11=D-Brown, 12=D-Gray
  50.           13=D-Blue, 14=D-Green, 15=Orange, (16+ Repeats)
  51.  
  52. =SS=   Specifies Color and Status for Sections (obsolete)
  53.      This command is obsolete (superseded by =S$=)
  54.      See the =S$= command listed above
  55.  
  56. =O=   Precedes Data Ordering Information
  57.      This command is followed by a series of Strings
  58.      Data Order may be changed anywhere in the survey.
  59.      Data Order may be changed as often as desired.
  60.      Example  =D=DIST AZIM INCL LEFT RIGHT UP DOWN
  61.      Keywords may be either uppercase or lowercase
  62.      Recognized keywords currently include:
  63.           DIST   LENGTH
  64.           AZIM   AZIMUTH
  65.           INCL   VERTICAL
  66.           LEFT   RIGHT   UP   DOWN   CEILING   FLOOR
  67.  
  68. =D=   Precedes a Magnetic Declination Value
  69.      This numeric value is added to all following azimuths.
  70.      Declination may be changed anywhere in the survey.
  71.      Declination may be changed as often as desired.
  72.      Example  =D=14
  73.  
  74. =P=   Precedes a Pattern% (SICN) for following stations
  75.      The specified pattern applies to all following stations
  76.      Example  =P=1
  77.      The Patterns list is long (1->50) and hard to describe
  78.      Patterns are best specified using 1-Point Stats
  79.      1-Point Stats is accessed by clicking on the lineplot
  80.  
  81. =A$=  Precedes an Attribute Char$, Mode$, Name$
  82.      This is used to specify info about an Attribute
  83.      To work properly, it should precede actual survey data
  84.      Example  =A$=W  A  Water
  85.      This example names Attribute #W "Water"
  86.      This example also sets Attribute #W to "AND" mode
  87.      Char$:  1st Set is ASCII 65(A) to 95(_)
  88.                  2nd Set is ASCII 97(a) to 126(~)
  89.                  Other ASCII values are ignored
  90.      Mode$:  A=AND (all attributes, ASCII=65)
  91.                  O=OR (some attributes, ASCII=79,48)
  92.                  N=NOT (has none, ASCII=78)
  93.                  -=Off (no mode selected, ASCII=45)
  94.                  Other ASCII values default to "Off"
  95.      Name$:  The name of the attribute
  96.      Only the first character of Char$ and Mode$ are used
  97.      Only the first 15 character of Name$ are used
  98.  
  99. =A=   Precedes a Station's Attribute$
  100.      The text characters are each mapped to an Attribute
  101.      Attributes are added only to the the next station
  102.      Each station may have its own Attributes specified
  103.      Example  =A=ABFcdr
  104.      Station attributes are best specified within CavePlot
  105.      See the =A$= command for more information
  106.  
  107. =F=   Signals the end of the survey data
  108.      This command tells CavePlot to stop importing data
  109.      This command is optional, but useful.
  110.      It can be used to import only part of the survey data
  111.      It should be used when the file is longer than the data
  112.      Example  =F=
  113.  
  114.